package com.ruoyi.examation.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.common.core.page.TableDataInfo;
import com.ruoyi.examation.domain.Exam;
import com.ruoyi.examation.vo.ExamVo;
import com.ruoyi.examation.vo.ExamClassExamVo;

import java.util.List;

/**
 * 考试信息Service接口
 *
 * @author Tellsea
 * @date 2025-09-28
 */
public interface IExamService extends IService<Exam> {

    /**
     * 分页查询
     *
     * @param entity
     * @return
     */
    TableDataInfo<ExamVo> queryList(ExamVo entity);

    /**
     * 查询全部
     *
     * @param entity
     * @return
     */
    List<ExamVo> queryAll(ExamVo entity);

    /**
     * 根据ID查询
     *
     * @param id
     * @return
     */
    ExamVo queryById(Long id);

    /**
     * 分页查询考试关联的班次列表
     *
     * @param examId 考试ID
     * @param entity 查询条件
     * @return 考试关联班次列表
     */
    TableDataInfo<ExamClassExamVo> queryExamClassList(Long examId, ExamClassExamVo entity);

    /**
     * 批量新增考试班次关系
     *
     * @param examId 考试ID
     * @param classIds 班次ID列表
     * @return 成功添加的数量
     */
    int addExamClasses(Long examId, List<Long> classIds);

    /**
     * 移除考试班次关系
     *
     * @param examId 考试ID
     * @param classId 班次ID
     * @return 影响行数
     */
    int removeExamClass(Long examId, Long classId);

    /**
     * 分页查询用户关联的班次的考试列表
     *
     * @param userId 用户ID
     * @param entity 查询条件
     * @return 考试列表
     */
    TableDataInfo<ExamVo> queryMyClassExamList(Long userId, ExamVo entity);
}
